home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 1 / ShareWare Extravaganza 1 of 4 (The Ultimate Shareware Company).iso / grprogs / cga2vga.exe / CGA2VGA.DOC < prev    next >
Text File  |  1988-03-06  |  7KB  |  176 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.               CGA2VGA (c) 1988 Lawrence Gozum & Marvin Gozum
  7.               ──────────────────────────────────────────────
  8.  
  9.                                 User Manual
  10.  
  11.     DISCLAIMER
  12.  
  13.     This  product  is distributed AS IS.  The authors specifically disclaim
  14.     all  warranties  ,expressed  or implied, including ,but not limited to,
  15.     implied  warranties  of  merchantability  and  fitness for a particular
  16.     purpose  with respect to defects in the diskette and documentation, and
  17.     program  license  granted  herein,  in particular, and without limiting
  18.     operation  of  the  program  license  with  respect  to  any particular
  19.     application  use  or  purpose.  In no event shall the authors be liable
  20.     for  any  loss  of  profit or any other commercial damage including but
  21.     not  limited  to  special,incidental,  consequential  or other damages.
  22.     You  are NOT licensed to use or distribute this program in states where
  23.     this disclaimer is not considered in effect.
  24.  
  25.  
  26.     LICENSING AGREEMENT
  27.  
  28.     You  may  use  this program on a TRIAL BASIS only;  this means that you
  29.     may  freely  evaluate  the  usefulness of this program for a reasonable
  30.     period.    Should  you  find  this program useful, you must register by
  31.     sending  in  registration  form with a check payable to Marvin Gozum in
  32.     the  amount  of  $8.95.   You will then be provided with a personalized
  33.     copy  of this utility.  As a bonus, you will receive the latest version
  34.     of VGACAD (VGA Computer Assisted Design).
  35.  
  36.     You  may  freely  distribute  copies  of this program in its UNMODIFIED
  37.     state  provided  you do not include it in other software packages, with
  38.     the  exception  of distributing it as part of a bundle of Public Domain
  39.     or  shareware  programs  on a single diskette.  In addition you may not
  40.     charge  more that $3.50 for copying and/or distributing this program in
  41.     the absence of any recognized Users Group guidelines.
  42.  
  43.  
  44.     INTRODUCTION
  45.  
  46.     VGA  (Video Graphics Array) is now the de facto video graphics standard
  47.     in  the  IBM  PS/2  series  (Model  50,60  and  80).  MCGA (Multi-Color
  48.     Graphics  Array)  is  supported by Model 30; I'm not sure what Model 25
  49.     supports.    Although  VGA has a 640x480 pixel mode, it only supports a
  50.     maximum  of 16 colors - ala EGA (Enhanced Graphics Adaptor).  The  MCGA
  51.     256  color  mode  with  a  resolution  of 320x200 pixels provides near-
  52.     photographic   quality   as   well   maintains   a  broad  spectrum  of
  53.     compatibility  with  the  new  PS/2  machines  since it is not only the
  54.     lowest  common  denominator (in graphic modes) but it provides the most
  55.     astounding results.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.     CGA2VGA  is  a terminate-stay-resident (TSR) utility that allows you to
  73.     capture  CGA  4-color  graphic  screens  (even  2  color  screens)  and
  74.     translate  then  into  VGA  and MCGA screens in MCGA 256 color mode and
  75.     save  the screen in a "Bloadable" format.  Once saved you can edit your
  76.     old  pictures  and  increase their color range wiht your favorite paint
  77.     or CAD program (VGACAD is particularly designed to do that task).
  78.  
  79.     Since  the  MCGA  256  color mode uses 64K of contiguous memory without
  80.     bit-planes,    it  makes  it  possible  for  you  Bsave and Bload these
  81.     screens  without  much  of  a  fuss, regardless of the BASIC program or
  82.     BASIC  compiler you are using.  Thus, you will be able to make dazzling
  83.     presentations  or slideshows effortlessly using digitized pictures that
  84.     you  have  downloaded  from  various  BBSs  or  screens  designed  with
  85.     different painting or CAD programs.
  86.  
  87.  
  88.     HOW TO USE CGA2VGA
  89.  
  90.     Simply  run  CGA2VGA  before  entering  your  painting/CAD or digitized
  91.     picture  viewer.   After it is loaded,  press <ALT-F2> and your current
  92.     screen  will  be  saved to your default directory and drive.  The first
  93.     time  you  run  the program it will save your screen to a file labelled
  94.     MCGASCRN.000  and  will  increase  thereafter  up  to .999.  If CGA2VGA
  95.     continues  to  be resident, the latest file number will be incremented,
  96.     regardless  of  the screens captured in the default directory or drive.
  97.     If  there  is  an  existing MCGASCRN.xxx, then it will increment to the
  98.     next  higher  number.    That  is all there is to it.  You can use your
  99.     favorite  memory  managers  to remove this TSR or reboot if you want to
  100.     release it from memory.
  101.  
  102.  
  103.     REQUIREMENTS
  104.  
  105.     It  goes  without  saying  that  you  MUST  have  a VGA adaptor or MCGA
  106.     adaptor  (BIOS  compatible  at the very least) present and an analog or
  107.     multi-frequency  monitor  as well.  This TSR uses 64K of your available
  108.     memory;   therefore your application must have enough free memory along
  109.     with your other TSRs for it to function properly.
  110.  
  111.     If  you are in DOS,  there is a good chance that the program will cause
  112.     your  system  to  hang.    Make  sure  you invoke this TSR only in your
  113.     application  as  well  as  making sure that you are in the right screen
  114.     mode.  Later versions should correct this little irritant.
  115.  
  116.     QuickBASIC  4.0 users should be careful of calling this TSR when in the
  117.     program  development/editor  environment.   The program will cause your
  118.     system  to  hang when invoked during a QB 4.0 development session since
  119.     it  manages  the memory and video modes to run several modules.  I hope
  120.     to correct this in later releases.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.     BLOADING FROM BASIC
  139.  
  140.     The  following  lines  will  load  one  of  the  captured  screens from
  141.     QuickBASIC 4.0
  142.  
  143.  
  144.     Screen 13:                           'init MCGA 256 color mode
  145.     DEF SEG=&HA000:                      'point data segment to
  146.                                          'screen buffer A0000H
  147.     Bload "MCGASCRN.000",0:              'load the screen
  148.     DEF SEG   :                          'restore data segment
  149.  
  150.  
  151.     If  you  are  using  a  QuickBASIC  1.0,  2.0  or  3.0, I have included
  152.     VGAMODE.obj  which  is  an  object file created with MASM 4.0 which you
  153.     can  include in your UserLib.exe thorough BUILDLIB.exe.  VGAMODE.obj is
  154.     a  BIOS  compatible assembly routine which you can use to call even the
  155.     more  exotic graphic modes that your compatible VGA card can handle (if
  156.     you  are  using one).  The following lines will perform just as well as
  157.     the listing above.
  158.  
  159.  
  160.     Call VGAMODE(&H13):                  'init MCGA 256 color mode
  161.     DEF SEG=&HA000:                      'point data segment to
  162.                                          'screen buffer A0000H
  163.     Bload "MCGASCRN.000",0:              'load the screen
  164.     DEF SEG   :                          'restore data segment
  165.  
  166.  
  167.     REGISTRATION
  168.  
  169.     Send  the  registration  form  or  a  card  stating  your full name and
  170.     address and a $8.95 check made payable to:
  171.  
  172.                                Marvin Gozum
  173.                       2 Independence Place Apt. 303-2
  174.                             6th & Locust Street
  175.                           Philadelphia, PA 19106
  176.